This folder contains the principal developer documentation for OpenDoc for the Mac™ OS (though there have been some changes — see the bottom of this document for details). The subfolders contain the following documents:
Acrobat Documents
Contains the OpenDoc Class Reference, OpenDoc Programmer's Guide, and OpenDoc Cookbook in Acrobat format, all indexed for full text search
QuickView databases
Contains the OpenDoc Class Reference in QuickView™ format, which gives you hypertext access to the OpenDoc API descriptions in the same manner as Macintosh Programmer's Toolbox Assistant.
Also contains recently created QuickView databases of the OpenDoc Programmer's Guide and OpenDoc Cookbook, giving you direct QuickView access to overview information and sample-code tutorials as well as API reference.
• To view the Acrobat documents on this CD, you must first install Acrobat Reader 2.1
with Search for CD ROMs. For instructions, see “Installing Acrobat Reader 2.1” in the
Acrobat Reader 2.1 folder within the Utilities folder.
• To use the fast indexed text search with theClass Reference, Programmer’s Guide,
and Cookbook, see “Fast Text Search with Acrobat!” in the Acrobat documents folder
within this folder.
• To view the QuickView version of the documentation, see “Using
QuickView with OpenDoc” in the QuickView databases folder within this folder.
Human Interface
Contains the Drag and Drop Human Interface Guidelines and the OpenDoc Human Interface Specification in Acrobat format. Also contains Human Interface Q & A, a collection of articles presenting answers to the most commonly asked questions about the OpenDoc user interface, and a set of instructional HI demos.
Recipes, Tech Notes & Articles
Contains these folders with additional technical documentation:
• Tech Notes: programming hints and utilities documentation
• Recipes: discussions and code provided by the OpenDoc development team
• develop™ Articles: OpenDoc programming articles from develop magazine
ODF Documentation
An alias to overview and reference documentation, aws well as development notes, for the OpenDoc Development Framework (ODF).
NOTE: Changes / Errata
Some of the developer documentation has undergone revisions too recent to be reflected in all the documents here. The Recipes are the most up-to-date and complete guides to writing OpenDoc parts, and should be consulted by all developers. The Recipes folder includes two very recent files, "OpenDoc Pgmr's Guide Errata" and "Drag&Drop Changes Since DR4", which deserve special attention though other recipes contain updates and corrections as well.